---
displayed_sidebar: "Chinese"
---

# months_diff

## 功能

计算开始时间和结束时间相差几个月（`expr1` - `expr2`），结果精确到月。

## 语法

```Haskell
BIGINT months_diff(DATETIME expr1, DATETIME expr2);
```

## 参数说明

`expr1`: 结束时间，支持的数据类型为 DATETIME。

`expr2`: 开始时间，支持的数据类型为 DATETIME。

## 返回值说明

返回值的数据类型为 BIGINT。如果日期不存在，则返回 NULL。如果相差不满一周，则返回 0。

## 示例

```Plain Text
select months_diff('2010-11-30 23:59:59', '2010-1-1 23:59:59');
+---------------------------------------------------------+
| months_diff('2010-11-30 23:59:59', '2010-1-1 23:59:59') |
+---------------------------------------------------------+
|                                                      10 |
+---------------------------------------------------------+
1 row in set (0.01 sec)
```
